package com.doubao.device.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.doubao.common.result.Result;
import com.doubao.device.config.DeviceVoiceConfig;
import com.doubao.device.dto.AIModelInfoDTO;
import com.doubao.device.dto.ApiConfigDTO;
import com.doubao.device.dto.SmartDeviceDTO;
import com.doubao.device.dto.VoiceConfigDTO;
import com.doubao.device.dto.request.CreateDeviceRequest;
import com.doubao.device.dto.request.DeviceQueryRequest;
import com.doubao.device.dto.request.UpdateDeviceRequest;
import com.doubao.device.entity.SmartDevice;

import java.util.List;

/**
 * 智能体服务接口
 */
public interface SmartDeviceService extends IService<SmartDevice> {

    /**
     * 创建智能体
     *
     * @param userId 用户ID
     * @param request 创建请求
     * @return 创建结果
     */
    Result<SmartDeviceDTO> createDevice(Long userId, CreateDeviceRequest request);

    /**
     * 更新智能体
     *
     * @param userId 用户ID
     * @param request 更新请求
     * @return 更新结果
     */
    Result<SmartDeviceDTO> updateDevice(Long userId, UpdateDeviceRequest request);

    /**
     * 删除智能体
     *
     * @param userId 用户ID
     * @param deviceId 智能体ID
     * @return 删除结果
     */
    Result<Void> deleteDevice(Long userId, Long deviceId);

    /**
     * 获取智能体详情
     *
     * @param deviceId 智能体ID
     * @param userId 当前用户ID，可为null
     * @return 智能体详情
     */
    Result<SmartDeviceDTO> getDeviceDetail(Long deviceId, Long userId);

    /**
     * 获取智能体配置信息（包括API和语音配置）
     *
     * @param deviceId 智能体ID
     * @param userId 当前用户ID，可为null
     * @return 智能体配置信息
     */
    Result<SmartDeviceDTO> getDeviceConfig(Long deviceId, Long userId);

    /**
     * 分页查询智能体
     *
     * @param request 查询请求
     * @param userId 当前用户ID，可为null
     * @return 智能体分页列表
     */
    Result<IPage<SmartDeviceDTO>> pageDevices(DeviceQueryRequest request, Long userId);

    /**
     * 获取推荐智能体列表
     *
     * @param limit 数量限制
     * @param userId 当前用户ID，可为null
     * @return 推荐智能体列表
     */
    Result<List<SmartDeviceDTO>> getRecommendDevices(Integer limit, Long userId);

    /**
     * 获取热门智能体列表
     *
     * @param limit 数量限制
     * @param userId 当前用户ID，可为null
     * @return 热门智能体列表
     */
    Result<List<SmartDeviceDTO>> getHotDevices(Integer limit, Long userId);

    /**
     * 获取最新智能体列表
     *
     * @param limit 数量限制
     * @param userId 当前用户ID，可为null
     * @return 最新智能体列表
     */
    Result<List<SmartDeviceDTO>> getLatestDevices(Integer limit, Long userId);

    /**
     * 获取用户创建的智能体列表
     *
     * @param userId 用户ID
     * @param page 页码
     * @param size 每页大小
     * @return 智能体分页列表
     */
    Result<IPage<SmartDeviceDTO>> getUserDevices(Long userId, Integer page, Integer size);

    /**
     * 搜索智能体
     *
     * @param keyword 关键词
     * @param page 页码
     * @param size 每页大小
     * @param userId 当前用户ID，可为null
     * @return 智能体分页列表
     */
    Result<IPage<SmartDeviceDTO>> searchDevices(String keyword, Integer page, Integer size, Long userId);

    /**
     * 更新智能体状态
     *
     * @param userId 用户ID
     * @param deviceId 智能体ID
     * @param status 状态 1:正常 0:禁用
     * @return 更新结果
     */
    Result<Void> updateStatus(Long userId, Long deviceId, Integer status);

    /**
     * 增加智能体使用次数
     *
     * @param deviceId 智能体ID
     * @return 更新结果
     */
    Result<Void> increaseUsageCount(Long deviceId);

    /**
     * 增加智能体token使用量
     *
     * @param deviceId 智能体ID
     * @param promptTokens 输入tokens
     * @param completionTokens 输出tokens
     * @return 更新结果
     */
    Result<Void> increaseTokenUsage(Long deviceId, Long promptTokens, Long completionTokens);

    /**
     * 获取智能体绑定的AI模型信息
     *
     * @param deviceId 智能体ID
     * @return AI模型信息
     */
    Result<AIModelInfoDTO> getDeviceAIModel(Long deviceId);

    /**
     * 根据分类ID查询智能体列表
     *
     * @param categoryId 分类ID
     * @param page 页码
     * @param size 每页大小
     * @param userId 当前用户ID，可为null
     * @return 智能体分页列表
     */
    Result<IPage<SmartDeviceDTO>> getDevicesByCategory(Long categoryId, Integer page, Integer size, Long userId);

    /**
     * 根据标签ID查询智能体列表
     *
     * @param tagId 标签ID
     * @param page 页码
     * @param size 每页大小
     * @param userId 当前用户ID，可为null
     * @return 智能体分页列表
     */
    Result<IPage<SmartDeviceDTO>> getDevicesByTag(Long tagId, Integer page, Integer size, Long userId);

    /**
     * 获取智能体API配置
     *
     * @param deviceId 智能体ID
     * @return API配置
     */
    Result<ApiConfigDTO> getDeviceApiConfig(Long deviceId);

    /**
     * 获取智能体语音配置
     *
     * @param deviceId 智能体ID
     * @return 语音配置
     */
    Result<VoiceConfigDTO> getDeviceVoiceConfig(Long deviceId);
    
    /**
     * 获取用户显示名称
     *
     * @param userId 用户ID
     * @return 用户显示名称
     */
    String getUserDisplayName(Long userId);
}